Skip to content

Conversation

@anish-devgit
Copy link

Summary

Fixes #148

Creates a comprehensive, org-wide CONTRIBUTING.md that consolidates best practices from all AboutCode projects into a single, accessible guide.

Changes Made

  • [NEW] CONTRIBUTING.md in repository root (Markdown format for GitHub visibility)
  • [MODIFIED] docs/source/contributing.rst - added prominent reference to new guide

Key Features

Content Sources

  • VulnerableCode: Welcoming tone, ways to contribute structure
  • ScanCode.io & DejaCode: Development workflow, project-specific sections
  • AboutCode existing: Documentation guidelines, commit messages
  • OmniBOR: Overall structure and simplicity inspiration

Benefits

✅ Single source of truth for all AboutCode contributions
✅ More accessible than scattered RST documentation
✅ Top-level GitHub visibility (CONTRIBUTING.md auto-linked)
✅ Preserves project-specific guides via links
✅ Emphasizes small PRs and matching existing code style

- Created comprehensive CONTRIBUTING.md in repository root
- Consolidates best practices from VulnerableCode, ScanCode.io, and DejaCode
- Follows OmniBOR's simple, accessible design pattern
- Emphasizes small PRs and code style matching
- References issue referencing guidelines from aboutcode-org#106
- Links to existing detailed guides (commit messages, docs)
- Updated contributing.rst to prominently link to new guide

This provides a single source of truth for contributing across all
AboutCode projects while preserving project-specific documentation.

Fixes aboutcode-org#148

Signed-off-by: Anish <anishkumar@example.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create org-wide contributing document

1 participant